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Here's how | approach 
Learning hard things 
and getting better 
at programming! 
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Í dont always feel like a wizard, I'm not the most 
Experienced member on my team, like most people I find 
my, work difficult sometimes, and I have a TON TO LEARN. 


But over the past S years Tve learned a few things that 
Have helped me. We'll talk about : 


-how asking dumb questions is actually a superpower 
- debugging tools that help you FEEL like a wizard 

- how learning to write a design doc has helped me 
-how to approach learning a complex system 


- reading the source code to your dependencies and 
why that's useful 


This zine definitely won't teach you to be a wizard 


by itself, bot hopefully it has one or two useful 
tips! 


A lot of it is aimed at me, a little earlier 
in my career wy 


TABLE OF Contents 


Here's what we'll cover V 





T learned just 
what I needed 
to know 





Z asking good 
questions 


- reading the Fi 


















this code is 
undocumented but 
T can handle that 






Source code 


° tricky bug? this 
f i ill 
sae Cane! 


o 






o 


2 designin 5! Ç 
a Duilding expertise g 





big underspecified 
Problem? let's start! 










How do I learn 
Some thing that takes 


years to master ? 


wow T learned So MUCH 
at my job this year 






o 


- Strategies For learning 








How to be a Wizard 


Programmer 





who can do anything (takes a very long time) 


OASK QUESTIONS. As long as there are people around 
you who know things you don't, ask them how to do things. 


Dumb questi ons. Scary -to- ask questions. 
Your questions will get less dumb fast. 


Run into a problem your coworkers dont know 
how to solve either. 
@ DECIDE You witt FIGURE OUT HOW TO 


SOLVE THE PROBLEM ANYWAY 
(this is very hard but sometimes it works JU) 


The more programming I do, the more issues T run into where: 
- I dont know 
- my colleagues don't Know 
- Google doesn't know 
- we gotta Figure it out anyway 


When this happens, I think: 





Right, this is why they Pay a 
human witha brain (me ltt) 
who can investigate and learn 





enue 





This zine is about what the skill of “Figure 
it out anyway” looks like. 


When to invest in understanding ? 


We work with a lot of abstractions . You don't always need to 
spend time understanding how they all work under the hood. 


SaaS how does Lieu oes wifi work?) work? g 


No ideal never needed 
But a huge part of becoming a wizard is understand ing 









o learn about that yet. 


how a see ming ly magical computer system works. 
When is it useful to spend time learning how a thing works? 


© When Youre traing to debug a tricky problem 


— Sometimes the librairies yov depend on have bugs 


— Of ten librairies /systems (like CSS, Linux) have complex 
Abstractions [te box model" \that take time to learn 
t epoll “on Linux 


© When youre trying to push the limits / optimize performance 


T don't always think about the hardware my code runs On. 


But if you're writing data to a file, you're always 
limited by the speed of your disks! 


© When you're trying to imovate 


Tf youre building a new abstraction (like an 


async library) , you gotta understand how 
the next layer down wor ks! (epoll, select etc) 


Asking Qood quest ions 


One of mu, favourite tools for learning is asking 
questions of all the awesome people I know! 


- 


> what's a good question? = 


good questions: 
kare easy for the person to answer 


* get you the information you're looking for 


Here are some strategies foc asking them: 









state what you know This helps because 


so, Í ki hen the > 
databus geks a lo - Im forced to think about 


of writes, the hard what I know 
drive can't keep up. 
- Tim less likely, to get answers 


thats right] 1 that are too basic or too 
don't think that was 

our prodlen though, advanced 

look at this- ~ 


oe, Guess what the 
ae to guess what the answer might be 
ns . 
a ne G the question Do we have 5 load 

9 e makes me think and balancers because we et 


a lot of 
Can sometimes he]p them set male 


See what Kiad ot answer actually we just 
Im loo King For. want to be sure it's 
ok if one goes doun 









choose who to ask 


: : your coworker with 


the database's Pai more experience 
creator thon you 


robably a better choice, has a 
qood shot at answering your 


question + way more time & 


Especially it T have LOTS 
of questions, it's good to be 
respectful of their time 4 





do some research 


‘<— 
The per Son who Knows the 


MOST isn't always the best 
person toask T 

Often someone who learned it 
more recently will remember better 
what it was like to not understand, 


Find a good time 


about database 
performance for 
20 minutes ? 


Yeah | after lunch! 


So I Found out that E €E TFI spend some time 


creating database 


indexes takes time, 
what happens if 


T run a query during 





index creation? 


— 
Iv asking yes/no questions 


like this because they ‘re 
easier to answer and it means 
T have to focus the question 
care fully 





doing research first, I 


can ask a WAY BETTER 
question w 


ask yes/no questions 


does this database 
take out a lock 


When it does writes? 


yes! Here are the 

docs you should read 

if you want to know 
morel 


read the source code 


Okay, but you cant ALWAYS ask people questions T 
Sometimes: 

~ there's no documentation 

>. Your coworkecs are busy 

> or they don't know the answer 

> or yov want to know A LOT more details 

than it is really reasonable to ask about 

Ht 


DELIGHTED 
Linux kernel 
One day, I wanted to know if I Source 
Could configure a socket on Linux to 
not gueve connections. T Googled and cyot some. 


conflicting answers. But one of the Stack Overflow answers 
linked directly +o the KERNEL y 
cove f 


Luckily, we have open source 






T have an extremely 
Specific question 
aboot the Linux 
kernel 


T+ looked basically lke: hacdcoded constant ! 


backlog= max (backlag , g) 


So it's impossible to set the backlog to O. 
Tt'll always end up being at least W 





Tips for reading code 
not sure, but nobody 5 
touched it For a year & 


rae, does this 
Cocle rae, 
today it's broken 


“Ce ine oT SD (Gk, time 40 Find oo to find out 






Here are some things Te found help when dealing 
with unfamiliar code : 


grep foc the When I see an error message 
error message T dont understand, searching 


THATS cE the source for it is really easy 


that error pi Some times helps 
message means 4 





1S the code Im using is just read the whole source 
less than a few thousand oh, this just runs 
lines, I like to quickly tryto the “sync AW function 
read it all to learn the basics every 10 second s 


ot how it works 





edit the code Get your hands dirty f 


what happens if - step through with a debugger! 
T change THIS ? - add tests! 
- add print statements! 


~ introduce bugs! 

- experiment ! 

- don't always trust 
the comments Ù 





debugging: w love your bugs ¥ 


(thanks to Allison Kaptur for teaching me this attitude 1 
she has a great talk called Love Your Bugs 


Debvaging is a great way to learn. First: the harsh 
reality, of bugs in your code isa qood way to reveal 
problems with your mental model. 


error: too many 
open files 


Pe ogram 







T can't just open aS 
mony files as T want? 
Interesting, 1 


Fixin bugs is also a qood way to learn to write 
more reliable code? 






o0? 


hmm, T should put in eror 
hond ling here in case that 
dota base query times out 


Also, yov qet to sove a mystery and get immediate 
feedback about whether you were right or not. 


$ f -9 aea 
TN 4&7 Codin : 


Nobody, writes great code without writing + Fixing lots of 
bugs. So lets talk about debugging skills a bit! 





how I got better 
at debugging 





/ Remember the bug is happening 


for a logical reason. 


T4's never magic. Really. Even when it makes no sense. 


B[Be confident L can fix it 


Er 
te GEED m F 


4. Talk to my wa: 


So G m 


y Know my debugging toolkit 
before: 






well Ive fixed 
alot of hard 
bugs before 


now: 









aa want to Know 
$ THING but I 

don't Know how 
to Find out 


o 





J most importantly : T leacned to like it 


a no ° (Lthink T7 
before: Y o a nk Tm 









about to lean 


Some thing 


N facial ex pression: 
determination 


learn ing at work 


Almost everything T Spend time on day to day is 
Some thing, The learned on the job. 









hmm L need to 
use Kubernetes at 
work but I don't 
understand it well 


o? set aside work time to 
=> -(ead source cade 
-ask questions 
- Watch talks 
-read docs / blog posts 


- do ex periments 


Debugging is one way to learn at work. Here are more ways! 


follow up on bugs Volunteer to do work 
T couldn't Figure out that seems hard 


2°f0oh, Someone else Cee sure” T'I 
Fixed that, let's joes it oot 
See how 

x 


Tm not always 100% 
Sure, but it's worth trying 


pay attention to 
others ‘code watch more senior 


eople operate 
To ooh oa one has Bee P 


Some great ideas! 


“ thet person does AWESone 
work how do they do it?” 





don't: advocate for using something at work just because I 
E want to learn it 


learning on my own 


implement something 
that seems hard 


especially in an area gzip! tcp! keyboard drivert 
I don't Know well debugger f 


(like Linux Kernel networking) 


hmm can I debug 
Py thon with gdb? 














ick a concept + 
Spend % hours on it $ o? 
b-trees! epollf asynciol 


read a paper do some experiment $s 










Adrian Coluec's “Chow many 
d u ts/ 
“The Morning Paper i requests /sec 
l can T serve 
has amazing paper with Flask? 
Summaries 
x x 
teach /blog itl 
x * 


A huge part of my learning process is teaching as I learn! 


Reasons it helps: 
—» it forces me to realize 


> revisitin basic questions 
iS impo ‘ant when I don't actuall 
Understand something 
well yet 


(wait, L didnt realize 
Unix groups did that 





How *does* asynchronous 
programming work? 





o 


learning to ‘design’ software 


A a 
MITTEE 


It's surprisingly easy to end up in this situation: 


T'I start (oh no this is 
coding I ... 2 months totally not 
- later what we 
\ 


needed to build 










A little bt of y plannin @ helps me make sure my 
hard work doesn’t go to waste. 


Here are a few things that help me to remember: 


* you can't predict how requirements will change 


a get la s 


T just try my best and deal with changes when they come 









let's reprocess 
every record 
every day 


ok, doing that is 
Way too expensive 
now 






* "qood enough" is often really awesome 





00% 


+» 2 years later... Ş 


* making a proof of concept can really help 


Gone) bet we Gan make 
eee lx faster 


Comi Leoni ritar) 





Wow it's still 
working with 
no problems 









Show me a protol spe 
and T'll believe it 





Scenes from writing 
design docs 


when I start writing it 


hmm, T hasn't 
thought about how 
that part should 


Work before I 
wrote it down! 


designing Small projects: 
still useful 


> OD 30 minutes <=) 


When L start coding 


huh, this is a lot 
Easier now | 


Original plan 


^a O 
00000 


people who 
Understand the project 
better 


me! a my team! 


*Kmy manager ¥ Y other 
teams l 


MA 


when people disagree 
(and it goes well) 


T dont wie (Shea 
4 r Pe a END 
right... 


we n ie a better 
plan together T 


3 months into the 
project 
what actual 
happened 
A *o 
Ooooo 


A 


designs always change & 





let's build expertise I 


Let's zoom out a bit. A lot of the people I 


admire the most have been working on getting 
better at what they do for * years x. 


Tve found it useful to pick a few things I’m really interested 
in (like Linuxf) and Focus on those. 

Things The spent significant amounts of time 

Cat least a year) working on getting better at: 


- Linux networking T 
- debugging + profiling tools T 
- machine learning 1, 
- planning projects at work t 
- technical writing / speaking $ 
There ate lots of things (Gol Databases | Javascript!) 


that are important and IL know a litte about but haven't 
Spent that much time on. That's okay 


THs super fon to see a progression like 











0° (Tim going to 
learn about 
networking, 





oh wow Im 


a lot better 
at this now! 


... Omonths... 
later 


and T think © picking something te Focus on, and 
b) * actively * working on getting better at it is how all 
the people T admire got where they are. 


it's not too late to start learning, 


T started learning Linux in high school, in 2003. In 2013, 
after using it every, doy for 10 years, T realized 
some thing kind of scary. 







um... IT dont know 
what the Linux kernel 


DOES at all vy 






Solia, 201% 


There were all KINDS of concepts that I either 
didnt understand or didn't even know existed + 


9 9g 
CPU scheduling 


Sust today Cin 20171) L realized T don't fully, understand 
how Linux users /gcoups work . No big dealf T picked up my 
Copy of “The Linux Programming Interface” , read 
Chapter q, and now L understand. 






today is the 
best day +o 
Start learning I 





alceadų ? 


ways to build expertise 


learn fundamental concepts 


"system call’? 
What's that? 


0) figure out which ideas are 
the most important 
® Learn them 7 


read books 


Linux NETWORKING FOR 


SYSTEM ADMINISTRATORS 
Mich AgL 
Rogert Love PEC EUEAS 


Even just reading a 
few chapters of a 
good book can help ! 


When you don't understand 
ey dig in 


(hat's weird Y Ss (hat's weird Y 


“a figure it out x 


new llI 


do experiments T 


what ie calls an 
is THIS ie using?) VIN an 


What happens if 
Tun out of memory 
on pecpose ? 


do hacd projects 


000 (ooh Id need to 

Y learn a lot more 
to do that 
pro ject 


Till work on 
that ! 


dont forget: it takes a long time 


after 3 years I know 
a lot... but there's 
alot more still i 





take on hard projects 


To wrap uP, fetis talk about one last wizard skill: confidence 
when there's a hard project , sometimes T think: 






ə 





D 


Lm not sure, may be 
someone better than 
me should work on this 





and I imag ine this * magical * human: 


codes t a~, JÀ a Knows everything 


ceod fo © * about every, technology 
* * 
Understands the ~ * x -= great communicator 
business well x 


~~ has time for the project” 
20 years of experience 
in Prog camming : 

— were changing the tech we use all the time 

— every project is different and it's rarely 
obvious how to do ùt 

> there aren't many experts and they certainly 
don't have time to do everything . 


So instead , I take myself : 


bate ies. © figure “someone's gotta do this”, 
6 years of A write down a plan, and get 
experience started! A lot of the time it 
Qood at Z torns out well, I learn something, 
de bugging and feel a little more like a 


y 


like this ? 
you can print more V 


for free V 
http://jvns.ca/zines 
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